home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / MODULES / DUDF.ZIP / dudf / !Help next >
Text File  |  1997-10-07  |  5KB  |  123 lines
  1. du & df command line cutilities <= ie. a cute utility :-)
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. (c) Musus Umbra 1996
  5.  
  6. Permission is granted for unlimited personal use & modification.
  7.  
  8. Permission is granted for redistribution (by any method) provided that:
  9.     No charge is made for this software.  A reasonable charge may be
  10.         made for media / handling / etc. This software is *free*.
  11.     Any distributed copy of this software must be unaltered and entire.
  12.         You may not distribute modified / imcomplete copies of this
  13.         software.  If you fix a bug / add a feature, let me know so
  14.         that I can update the master copy.
  15.  
  16. As usual with freeware, there is no warranty of any kind.  The author cannot
  17. be help responsible for any loss/damage arising from the use/inability to
  18. use this software.  It is the user's responsibility to determine the fitness
  19. of this software for any purpose they put it to.
  20.  
  21. (But if it doesn't work, I will try to help :-)
  22.  
  23.  
  24. du
  25. ~~
  26.     du is a superior 'count' command.  Unlike the system count command,
  27. du provides flexible options controlling how the size of objects is
  28. calculated and displayed.  Use 'du -h' for help.
  29.  
  30.     Display options:
  31.  
  32.     -b, -k, -n :
  33.         These flags select what format directory sizes should be
  34.         displayed in.  -b selects 'byte' mode, i.e. the size in
  35.         bytes will be displayed.  -k selects 'K' mode, sizes are
  36.         displayed in kilobytes.  -n selects 'auto' mode, sizes
  37.         are displayed in bytes, kilobytes or megabytes as
  38.         appropriate.  The default is -k.
  39.  
  40.     -c, -C :
  41.         This flag enables (-c) or disables (-C) the use of commas
  42.         when displaying numbers over 1000.
  43.  
  44.     -r, -R :
  45.         Enables (-r) or disables (-R) rounding of *displayed*
  46.         numbers.  This flag DOES NOT affect the eventual results,
  47.         only the numbers printed on the screen.  If enabled,
  48.         all printed numbers will be rounded up/down to the nearest
  49.         unit (be that byte, kilobyte or megabyte).
  50.  
  51.     -m<n>, -M, -s :
  52.         This option sets the maximum depth into a directory tree
  53.         that du will output size information for.  Thus, -m1 causes
  54.         du to output size information for all the directories
  55.         in the counted directory (but no deeper).
  56.         -M sets the verbosity depth to 256, -s sets it to 0.
  57.         Thus, -s means just print the total size.
  58.         This option can be very useful, try du -m1 on your
  59.         !Fonts directory for example.
  60.  
  61.  
  62.     Counting Options:
  63.  
  64.     -d, -D :
  65.         Enables/disables the inclusion of the size of directories
  66.         in the count of themselves.  Directories actually occupy
  67.         disc space, however 'count' disregards this.  Using this
  68.         flag you can count the actual disc space used by a directory
  69.         (see -a flag below), or ignore the size of directories as
  70.         you see fit.
  71.  
  72.     -a<n>, -A :
  73.         The file size you get from, say, *Info is the extent of the
  74.         file.  Usually, this is smaller than the actual disc space
  75.         occupied by the file.  This is because disc space is
  76.         allocated in 'chunks'.  The -a option allows you to specify
  77.         what the size of a 'chunk' is (in bytes).  Typically, this
  78.         will be the size of an allocation unit on disc (usually
  79.         1024).  The default value is 1024.  Use -a0 (or -A) to
  80.         disable this feature.
  81.  
  82.     -i, -I :
  83.         Enables/disables the treatment of images as directories.
  84.  
  85.  
  86.     Command line syntax:
  87.         Invoke du with the syntax:
  88.             du [flags] [<dir> ...] [ [flags] [<dir> ... ] ... ]
  89.         Flags affect all the directories named after them only, thus
  90.         'du -s fred -m256 jim' displays only the total size of
  91.         'fred', but complete information on 'jim'.
  92.         If no directory is specified, then @ (ie. the CSD) is
  93.         assumed.
  94.         Flags may be catenated unless they require a numeric
  95.         argument. Thus, 'du -nCs fred' is valid, as is
  96.         'du -nCm4 -D fred', whereas 'du -nCm4D fred' is not.
  97.  
  98.     If you wish to alter the default options, you'll have to alter
  99. and recompile the source code.
  100.  
  101.  
  102.  
  103. df
  104. ~~
  105.     Well, du wouldn't be complete without df, would it?  df lists
  106. the capacities, names, types, etc. of available discs.  It's a bit like
  107. doing a '*free' on all your discs at once, with the exception that df
  108. also gives a %capacity figure.
  109.  
  110.     du is not perfect - it only knows how to get information from
  111. filecore filing systems (which is just about all of them), and a few
  112. of those are tricky.  In particular, df will ignore the RamDisc, MemFS
  113. and the like - this is because when asked they say 'No, I have no
  114. drives associated with me'.
  115.  
  116.     Basically, df is just a curio to bundle with du.
  117.  
  118.  
  119. Contact:
  120.     e-mail:        musus@argonet.co.uk
  121.     WWW:        http://www.argonet.co.uk/users/musus/
  122.     Snail:        c/o 23 Baronsway, Whitkirk, Leeds, LS15 7AW, ENGLAND.
  123.